IRIX Base Documentation 2002 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / miser.z / miser

Wrap

Text File | 2002-10-03 | 23.7 KB | 397 lines

mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) NNNNAAAAMMMMEEEE mmmmiiiisssseeeerrrr - configuration files DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The configuration of the _m_i_s_e_r(_1) Queues defines the resources allocated to the miser system. The configuration of _m_i_s_e_r(_1) involves two steps. The first is to enumerate all the queues that will be part of the _m_i_s_e_r(_1) system, and the second is to define the queues. The enumeration of the queues is done in the miser configuration file. The definition of the queues is done in the queue definition files. Each _m_i_s_e_r(_1) system requires that a system queue be defined. The system queue definition defines the maximum resources available to any other queue's definition. MMMMIIIISSSSEEEERRRR CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE The miser configuration file is a list of the queue names and the location of each queue definition file. QQQQUUUUEEEEUUUUEEEE ssssyyyysssstttteeeemmmm ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////ccccoooonnnnffffiiiigggg....ssssyyyysssstttteeeemmmm QQQQUUUUEEEEUUUUEEEE pppphhhhyyyyssssiiiiccccssss ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////ccccoooonnnnffffiiiigggg....pppphhhhyyyyssssiiiiccccssss SSSSUUUUMMMMMMMMAAAARRRRYYYY Each miser configuration file must include a definition for the system queue. The system queue is identified by the queue name "system". Commands are newline terminated, characters following the comment delimiter are '#' are ignored, and case matters. The valid tokens are: QQQQUUUUEEEEUUUUEEEE [qname] [[[[ffffiiiilllleeee ppppaaaatttthhhhnnnnaaaammmmeeee]]]] The queue name is used to identify the queue when using any interface to miser. The queue name must be between 1 and 8 characters long. The queue name _s_y_s_t_e_m is used to designate the system queue. QQQQUUUUEEEEUUUUEEEE DDDDEEEEFFFFIIIINNNNIIIITTTTIIIIOOOONNNN FFFFIIIILLLLEEEE The queue definition file consists of a header specifying the policy of the queue, the number of resource segments, and the quantum used by the queue. If the quantum of any queue is different from the system queue quantum, the queue definition file is rejected. EEEEXXXXAAAAMMMMPPPPLLLLEEEE #### TTTThhhhiiiissss qqqquuuueeeeuuuueeee ddddeeeeffffiiiinnnniiiittttiiiioooonnnn ffffiiiilllleeee ddddeeeeffffiiiinnnneeeessss aaaa qqqquuuueeeeuuuueeee uuuussssiiiinnnngggg tttthhhheeee ppppoooolllliiiiccccyyyy #### nnnnaaaammmmeeeedddd """"ddddeeeeffffaaaauuuulllltttt"""",,,, hhhhaaaassss aaaa qqqquuuuaaaannnnttttuuuummmm ooooffff 22220000 sssseeeeccccoooonnnnddddssss,,,, aaaannnndddd hhhhaaaassss 3333 #### eeeelllleeeemmmmeeeennnnttttssss ttttoooo tttthhhheeee vvvveeeeccccttttoooorrrr ddddeeeeffffiiiinnnniiiittttiiiioooonnnn.... TTTThhhheeee ssssttttaaaarrrrtttt aaaannnndddd eeeennnndddd ttttiiiimmmmeeeessss #### ooooffff eeeeaaaacccchhhh ttttuuuupppplllleeee aaaarrrreeee iiiinnnn qqqquuuuaaaannnnttttaaaa nnnnooootttt iiiinnnn sssseeeeccccoooonnnnddddssss.... TTTThhhheeee ffffiiiirrrrsssstttt sssseeeeggggmmmmeeeennnntttt #### ddddeeeeffffiiiinnnneeeessss aaaa rrrreeeessssoooouuuurrrrcccceeee ttttuuuupppplllleeee bbbbeeeeggggiiiinnnnnnnniiiinnnngggg aaaatttt 00000000::::00000000 aaaannnndddd eeeennnnddddiiiinnnngggg aaaatttt #### 00000000::::55550000 wwwwiiiitttthhhh 55550000 CCCCPPPPUUUUssss aaaannnndddd 111100000000 mmmmeeeeggggaaaabbbbyyyytttteeeessss ooooffff mmmmeeeemmmmoooorrrryyyy.... TTTThhhheeee sssseeeeccccoooonnnndddd PPPPaaaaggggeeee 1111 mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) #### sssseeeeggggmmmmeeeennnntttt ddddeeeeffffiiiinnnneeeessss aaaa rrrreeeessssoooouuuurrrrcccceeee ttttuuuupppplllleeee bbbbeeeeggggiiiinnnnnnnniiiinnnngggg 00000000::::55551111....66667777 aaaannnndddd eeeennnnddddiiiinnnngggg #### aaaatttt 00001111::::00000000 wwwwiiiitttthhhh 55550000 CCCCPPPPUUUUssss aaaannnndddd 111100000000 mmmmeeeeggggaaaabbbbyyyytttteeeessss.... TTTThhhheeee tttthhhhiiiirrrrdddd sssseeeeggggmmmmeeeennnntttt #### ddddeeeeffffiiiinnnneeeessss aaaa rrrreeeessssoooouuuurrrrcccceeee ttttuuuupppplllleeee bbbbeeeeggggiiiinnnniiiinnnngggg aaaatttt 00001111::::00002222....00000000 aaaannnndddd eeeennnnddddiiiinnnngggg aaaatttt #### 00001111::::00003333....33333333 aaaallllssssoooo wwwwiiiitttthhhh 55550000 CCCCPPPPUUUUssss aaaannnndddd 111100000000 mmmmeeeeggggaaaabbbbyyyytttteeeessss ooooffff mmmmeeeemmmmoooorrrryyyy.... PPPPOOOOLLLLIIIICCCCYYYY ddddeeeeffffaaaauuuulllltttt QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 NNNNSSSSEEEEGGGG 3333 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 55550000 MMMMEEEEMMMMOOOORRRRYYYY 111100000000mmmm SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 111155550000 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 55550000 MMMMEEEEMMMMOOOORRRRYYYY 111100000000mmmm SSSSTTTTAAAARRRRTTTT 111155555555 EEEENNNNDDDD 111188885555 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 55550000 MMMMEEEEMMMMOOOORRRRYYYY 111100000000mmmm SSSSTTTTAAAARRRRTTTT 111188886666 EEEENNNNDDDD 111199990000 SSSSUUUUMMMMMMMMAAAARRRRYYYY Commands are newline terminated, characters following the comment delimiter are '#' are ignored, and case matters. Each new segment must begin with the token SEGMENT and must have the number of CPUs, memory and wall clock time specified at a minimum. The valid tokens are PPPPOOOOLLLLIIIICCCCYYYY name The name of the policy that will be used to schedule applications submitted to the queue. Currently, the two valid policies are: "default", and "repack". The "default policy is the first fit policy, where once a job is scheduled, its start and end time remains constant. Each time any job ends on a queue with a "repack" policy the entire job schedule is reevaluated and updated. When machine resources are freed due an executing job's early termination, the repack policy will attempt to reschedule queued jobs, pulling them ahead in time. While repacking endeavors to maintain the FIFO order of queued jobs, a higher priority is given to the optimal utilization of machine resources. The actual start and end times of a job in a queue with a repack policy can potentially be earlier than its initially reported start and end times. See _m_i_s_e_r(_5). PPPPaaaaggggeeee 2222 mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) QQQQUUUUAAAANNNNTTTTUUUUMMMM time The size of the quantum. The time is specified in seconds. NNNNSSSSEEEEGGGG number The number of resource segments. SSSSEEEEGGGGMMMMEEEENNNNTTTT Defines the beginning of a new segment of the vector definition. SSSSTTTTAAAARRRRTTTT number of quanta from 0 The number of quanta from 0 (defined to be CTU) that the segment begins at. EEEENNNNDDDD number of quanta from 0 The number of quanta from 0 (defined to be CTU) that the segment ends at. The maximum acceptable END value is 259200. This represents a possible maximum run length of two months with a 20 second quantum size ((2 months * 30 days * 24 hours * 60 minutes * 60 seconds) / 20 seconds). The effective maximum queue duration can be increased beyond two months by increasing the quantum size. NNNNCCCCPPPPUUUUSSSS number of CPUs The number of CPUs. MMMMEEEEMMMMOOOORRRRYYYY amount of memory The amount of memory, specified by an integer followed by an optional unit of _k for kilobyte, _m for megabyte, and _g for gigabyte. If no unit is specified then the value is treated as byte. For all the examples, the machine has 12 CPUs and 160MB memory. EXAMPLE 1: A machine dedicated to batch scheduling with one queue, 24 hours a day. First System Queue must be defined. The length of the system queue defines the maximum duration of any job submitted to the system. For this system the maximum duration for any one job can be 48 hours, so the system vector is defined to have a duration of 48 hours. #### TTTThhhheeee ssssyyyysssstttteeeemmmm qqqquuuueeeeuuuueeee ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////ssssyyyysssstttteeeemmmm PPPPOOOOLLLLIIIICCCCYYYY nnnnoooonnnneeee #### SSSSyyyysssstttteeeemmmm qqqquuuueeeeuuuueeee hhhhaaaassss nnnnoooo ppppoooolllliiiiccccyyyy QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 #### DDDDeeeeffffaaaauuuulllltttt qqqquuuuaaaannnnttttuuuummmm sssseeeetttt ttttoooo 22220000 sssseeeeccccoooonnnnddddssss NNNNSSSSEEEEGGGG 1111 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000mmmm SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 8888666644440000 #### NNNNuuuummmmbbbbeeeerrrr ooooffff qqqquuuuaaaannnnttttaaaa ((((44448888hhhh **** 66660000mmmm **** 66660000ssss //// 22220000)))) PPPPaaaaggggeeee 3333 mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) Next a user queue needs to be defined. #### TTTThhhheeee uuuusssseeeerrrr qqqquuuueeeeuuuueeee ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////pppphhhhyyyyssssiiiiccccssss PPPPOOOOLLLLIIIICCCCYYYY ddddeeeeffffaaaauuuulllltttt #### FFFFiiiirrrrsssstttt ffffiiiitttt,,,, oooonnnncccceeee sssscccchhhheeeedddduuuulllleeeedddd mmmmaaaaiiiinnnnttttaaaaiiiinnnnssss ssssttttaaaarrrrtttt////eeeennnndddd ttttiiiimmmmeeee QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 #### DDDDeeeeffffaaaauuuulllltttt qqqquuuuaaaannnnttttuuuummmm sssseeeetttt ttttoooo 22220000 sssseeeeccccoooonnnnddddssss NNNNSSSSEEEEGGGG 1111 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000mmmm SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 8888666644440000 #### NNNNuuuummmmbbbbeeeerrrr ooooffff qqqquuuuaaaannnnttttaaaa ((((44448888hhhh **** 66660000mmmm **** 66660000ssss //// 22220000)))) Finally a miser configuration file must be created. #### MMMMIIIISSSSEEEERRRR ccccoooonnnnffffiiiigggg ffffiiiilllleeee QQQQUUUUEEEEUUUUEEEE ssssyyyysssstttteeeemmmm ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////ssssyyyysssstttteeeemmmm QQQQUUUUEEEEUUUUEEEE pppphhhhyyyyssssiiiiccccssss ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////pppphhhhyyyyssssiiiiccccssss EXAMPLE 2: A machine dedicated to batch scheduling, 24 hours a day and is shared between two user groups. Suppose we have 2 user groups, chemistry and physics. Suppose the machine must be divided between them, in a ratio of 66% for physics and 33% for chemistry. The system queue is identical to the one in EXAMPLE 1. #### TTTThhhheeee pppphhhhyyyyssssiiiiccccssss qqqquuuueeeeuuuueeee ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////pppphhhhyyyyssssiiiiccccssss PPPPOOOOLLLLIIIICCCCYYYY ddddeeeeffffaaaauuuulllltttt QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000iiii NNNNSSSSEEEEGGGG 1111 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 8888 MMMMEEEEMMMMOOOORRRRYYYY 111122220000mmmm SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 8888666644440000 #### NNNNuuuummmmbbbbeeeerrrr ooooffff qqqquuuuaaaannnnttttaaaa ((((44448888hhhh **** 66660000mmmm **** 66660000ssss //// 22220000)))) Now the chemistry queue: #### TTTThhhheeee cccchhhheeeemmmmiiiissssttttrrrryyyy qqqquuuueeeeuuuueeee ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////cccchhhheeeemmmmiiiissssttttrrrryyyy PPPPOOOOLLLLIIIICCCCYYYY ddddeeeeffffaaaauuuulllltttt QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 NNNNSSSSEEEEGGGG 1111 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 4444 MMMMEEEEMMMMOOOORRRRYYYY 44440000mmmm SSSSTTTTAAAARRRRTTTT 0000 PPPPaaaaggggeeee 4444 mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) EEEENNNNDDDD 8888666644440000 #### NNNNuuuummmmbbbbeeeerrrr ooooffff qqqquuuuaaaannnnttttaaaa ((((44448888hhhh **** 66660000mmmm **** 66660000ssss //// 22220000)))) To restrict access to each queue, the user groups physics and chemistry are created. The permissions on the physics queue definition file are set to execute ONLY for group physics and the permissions on the chemistry queue definition are set to execute only for group chemistry. Finally, the miser configuration file must be created: #### MMMMIIIISSSSEEEERRRR ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee QQQQUUUUEEEEUUUUEEEE ssssyyyysssstttteeeemmmm ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////ssssyyyysssstttteeeemmmm QQQQUUUUEEEEUUUUEEEE pppphhhhyyyyssssiiiiccccssss ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////pppphhhhyyyyssssiiiiccccssss QQQQUUUUEEEEUUUUEEEE cccchhhheeeemmmm ////uuuussssrrrr////llllooooccccaaaallll////mmmmiiiisssseeeerrrr////cccchhhheeeemmmmiiiissssttttrrrryyyy EXAMPLE 3: The machine is dedicated to TS in the morning but to batch in the evening. The evening is 8pm - 4am and the morning is 4am to 8pm. This is the same example discussed in _m_i_s_e_r(_1). First the system queue is defined. #### SSSSyyyysssstttteeeemmmm qqqquuuueeeeuuuueeee PPPPOOOOLLLLIIIICCCCYYYY nnnnoooonnnneeee #### SSSSyyyysssstttteeeemmmm qqqquuuueeeeuuuueeee hhhhaaaassss nnnnoooo ppppoooolllliiiiccccyyyy QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 #### DDDDeeeeffffaaaauuuulllltttt qqqquuuuaaaannnnttttuuuummmm sssseeeetttt ttttoooo 22220000 sssseeeeccccoooonnnnddddssss NNNNSSSSEEEEGGGG 2222 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000 SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 777722220000 #### ((((4444hhhh **** 66660000mmmm **** 66660000ssss)))) //// 22220000 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000 SSSSTTTTAAAARRRRTTTT 3333666600000000 #### 8888ppppmmmm iiiissss 22220000hhhhoooouuuurrrrssss ffffrrrroooommmm CCCCTTTTUUUU,,,, ssssoooo ((((22220000hhhh **** 66660000mmmm **** 66660000ssss)))) //// 22220000 EEEENNNNDDDD 4444333322220000 Next, the batch queue is defined. #### UUUUsssseeeerrrr qqqquuuueeeeuuuueeee PPPPOOOOLLLLIIIICCCCYYYY rrrreeeeppppaaaacccckkkk #### RRRReeeeppppaaaacccckkkkssss jjjjoooobbbbssss ((((FFFFIIIIFFFFOOOO)))) iiiiffff aaaa jjjjoooobbbb ffffiiiinnnniiiisssshhhheeeessss eeeeaaaarrrrllllyyyy QQQQUUUUAAAANNNNTTTTUUUUMMMM 22220000 #### DDDDeeeeffffaaaauuuulllltttt qqqquuuuaaaannnnttttuuuummmm sssseeeetttt ttttoooo 22220000 sssseeeeccccoooonnnnddddssss NNNNSSSSEEEEGGGG 2222 SSSSEEEEGGGGMMMMEEEENNNNTTTT PPPPaaaaggggeeee 5555 mmmmiiiisssseeeerrrr((((4444)))) mmmmiiiisssseeeerrrr((((4444)))) NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000 SSSSTTTTAAAARRRRTTTT 0000 EEEENNNNDDDD 777722220000 #### ((((4444hhhh **** 66660000mmmm **** 66660000ssss)))) //// 22220000 SSSSEEEEGGGGMMMMEEEENNNNTTTT NNNNCCCCPPPPUUUUSSSS 11112222 MMMMEEEEMMMMOOOORRRRYYYY 111166660000 SSSSTTTTAAAARRRRTTTT 3333666600000000 #### 8888ppppmmmm iiiissss 22220000hhhh ffffrrrroooommmm CCCCTTTTUUUU,,,, ((((22220000hhhh **** 66660000mmmm **** 66660000ssss)))) //// 22220000 EEEENNNNDDDD 4444333322220000 SSSSEEEEEEEE AAAALLLLSSSSOOOO miser(5), miser(1), miser_submit(1), miser_jinfo(1), miser_qinfo(1), miser_move(1), miser_reset(1). PPPPaaaaggggeeee 6666